home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / grafix / tools / pstoedit / readme < prev    next >
Encoding:
Text File  |  1996-02-26  |  3.7 KB  |  84 lines
  1. PSTOEDIT 
  2. Copyright (C) 1993,1994,1995 Wolfgang Glunz, Wolfgang.Glunz@zfe.siemens.de
  3.  
  4. pstoedit allows to convert Postscript(TM) files to a simple vector graphic
  5. format, that can be edited. Currently tgif, xfig, and Framemaker(TM)
  6. (MIF-format) and flat PostScript are supported.  Ask archie on where to
  7. find tgif or xfig.  pstoedit works by redefining the basic painting operators
  8. of Postscript. Others like image are not supported.  After redefining
  9. these operators, the Postscript file that needs to be converted is
  10. processed by GhostScript (gs). So you need to have Ghostscript in order
  11. to use this program.  pstoedit uses a postprocessor to actually build
  12. the input file for the editor.  This is a small lex-program (makeedit).
  13. To build it, just type make.  Edit the pstoedit script and change LIB
  14. according to your local environment. You need a C++ compiler, e.g. g++,
  15. to compile makeedit.
  16.  
  17. pstoedit works reasonable with PostScript files containing
  18.     * line drawings
  19.     * gray scale filled polygons
  20.     * text with standard fonts and no special encodings
  21. Try to run it on golfer.ps or tiger.ps that comes with ghostscript,
  22. e.g., pstoedit -f ?? examples/tiger.ps
  23. (You can directly use examples/tiger.ps without copying first as ghostscript 
  24.  searches this file in the ghostscript installation directory)
  25.  
  26. In particular pstoedit does not support
  27.     * bitmap images
  28.     * general fill patterns
  29.     * ... 
  30.  
  31. The output of gs that is piped to makeedit is a flat PostScript which only
  32. contains simple operations like moveto lineto, show, .... 
  33. You can look at this file using the -f debug option of pstoedit.
  34.  
  35. As an alternative one could also write backends based on the PostScript code
  36. generated from PostScript-To-PostScript translators like pstoai.ps or
  37. still.ps. Another alternative (as suggested by "David B. Rosen" <rosen@unr.edu>)
  38. would be to use the Gnu Graphics library as the basis for different backends.
  39.  
  40. There is one test (for the tgif backend) included. To run it type `make test'
  41.  
  42. To implement a new backend you can start from drvexample.c.
  43. See also drvbase.h (drvbase.3) for explanation of the methods that need to 
  44. implemented for a new backend.
  45.  
  46. If you just find this program useful, have made some improvements or other 
  47. backends please send a mail to Wolfgang.Glunz@zfe.siemens.de.
  48.  
  49. I've already a very basic backend to PDF which handles graphics and text
  50. that uses standard fonts and encodings. What kind of distribution policy
  51. do you think is suitable for that? Please email me your comments.
  52.  
  53. Installing pstoedit:
  54. --------------------
  55. *edit Makefile and  change 
  56.     BINDIR, LIBDIR, and MANDIR according to your local environment
  57.     You might also need to change the CC Variable to use your favorite C++ compiler.
  58. *edit pstoedit and change
  59.     LIBDIR to the same place as in Makefile
  60. type make clean; make; make install; [make test;] 
  61.  
  62.  
  63. Acknowledgements:
  64.  
  65. * Klaus Steinberger <Klaus.Steinberger@physik.uni-muenchen.de> who wrote the initial man page.
  66. * David B. Rosen <rosen@murmur> for some ideas and some PostScript code from his ps2aplot program.
  67. * Ian MacPhedran <Ian_MacPhedran@engr.USask.CA> for the xfig backend.
  68.  
  69.  
  70.  
  71.     This program is free software; you can redistribute it and/or modify
  72.     it under the terms of the GNU General Public License as published by
  73.     the Free Software Foundation; either version 2 of the License, or
  74.     (at your option) any later version.
  75.  
  76.     This program is distributed in the hope that it will be useful,
  77.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  78.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  79.     GNU General Public License for more details.
  80.  
  81.     You should have received a copy of the GNU General Public License
  82.     along with this program; if not, write to the Free Software
  83.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  84.